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CLAIMS 

1 . In a computer system, a method for retrieving events from an event port, 
the method comprising: 

receiving from a computer software application, a request to retrieve a 
specified number of events from an event port to which completed events are 
posted by one or more event sources; 

determining whether the specified number of events is available at the 
event port; 

if the specified number of events is available at the event port, retrieving 
the specified number of events from the event port and returning the retrieved 
events to the requesting computer software application; and 

if fewer events than the specified number of events are available at the 
event port, placing the request in a request queue with requests to be processed 
at a later time and ordering the request queue based on priorities of the requests 
in the request queue. 

2. The method of claim 1, wherein ordering comprises: 

placing requests with a higher priority ahead of requests with lower 
priority in the request queue. 

3. The method of claim 1, wherein ordering comprises: 

placing two or more requests with a same priority in a stack; and 
placing the stack in the request queue based on the priority of the 
requests in the stack. 

4. The method of claim 1 , wherein the specified number of events to be 
retrieved from the event port indicates a priority of the request. 

5. The method of claim 4, wherein a priority of a request is inversely 
proportional to the specified number of events. 



22 



Attorney Docket No.: SUN1 P765/SUN040374 



6. The method of claim 1, wherein the request queue contains requests 
generated by one or more computer software application threads. 

7. The method of claim 1, wherein the request queue contains requests 
5 generated by one or more computer software application processes. 

8. The method of claim 1 , wherein the number of events to be retrieved 
from the event port is specified by the computer software application. 

10 9. The method of claim 8, wherein the number of events to be retrieved 
from the event port is specified by the computer software application based on 
user input. 

10. The method of claim 1, further comprising: 

15 if fewer events than the specified number of events are available at the 

event port, determining whether there are any requests in the request queue that 
can be satisfied by the available number of events at the event port; and 

if there are requests in the request queue that can be satisfied, retrieving 
the specified number of events from the event port for one or more such requests 

20 and returning the retrieved events to the requesting computer software 
application. 

1 1. The method of claim 1, wherein the request has an associated timeout 
prior to which the request must be satisfied. 

25 

1 2. The method of claim 1 1 , further comprising: 

if a timeout occurs for a request while the request is in the request queue, 
retrieving all the available events at the event port at the time of timeout; and 
returning the request to the computer software application with the 
30 retrieved events. 
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1 3. The method of claim 1 , further comprising: 

returning an empty request to the requesting software application if the 
request cannot be satisfied. 

14. The method of claim 13, wherein returning comprises: 

returning the empty request together with an error code indicating the 
cause for why the request cannot be satisfied. 

15. The method of claim 1, further comprising: 

returning an empty request to the requesting software application if one 
or more of the following error conditions occur: 

the request contains an invalid event port identifier, an event or a list of 
events list cannot be delivered, a timeout argument is out of range, and a timeout 
interval expires before an expected number of events has been posted to the 
event port. 

16. The method of claim 1, wherein returning the retrieved events to the 
requesting computer software application comprises returning one or more of: 

one or more detected events, one or more event source identifiers where 
the detected events were generated, one or more objects specific to an event 
source, and one or more user defined values. 

1 7. The method of claim 1, further comprising: 

if the specified number of events is zero, identifying the number of 
available events at the event port; and 

informing the requesting computer software application of how many 
events are available at the event port. 

18. The method of claim 1, wherein the events are asynchronous events. 

19. The method of claim 1, wherein the events are transaction events. 
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20. The method of claim 1, wherein the event sources include one or more 
of: input devices, output devices, timers, signals, file updates, applications, 
system libraries, and drivers. 

21. A computer program product, stored on a machine-readable medium, 
comprising instructions operable to cause a computer to: 

receive from a computer software application, a request to retrieve a 
specified number of events from an event port to which completed events are 
posted by one or more event sources; 

determine whether the specified number of events is available at the 
event port; 

if the specified number of events is available at the event port, retrieve the 
specified number of events from the event port and returning the retrieved events 
to the requesting computer software application; and 

if fewer events than the specified number of events are available at the 
event port, place the request in a request queue with requests to be processed at 
a later time and order the request queue based on priorities of the requests in the 
request queue. 

22. The computer program product of claim 21, wherein the instructions to 
order comprise instructions to: 

place requests with a higher priority ahead of requests with lower priority 
in the request queue. 

23. The computer program product of claim'21, wherein the instructions to 
order comprise instructions to: 

place two or more requests with a same priority in a stack; and 
place the stack in the request queue based on the priority of the requests 
in the stack. 

24. The computer program product of claim 21, wherein the specified 
number of events to be retrieved from the event port indicates a priority of the 
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request. 

25. The computer program product of claim 24, wherein a priority of a 
request is inversely proportional to the specified number of events. 

5 

26. The computer program product of claim 21, wherein the request queue 
contains requests generated by one or more computer software application 
threads. 

10 27. The computer program product of claim 21, wherein the request queue 
contains requests generated by one or more computer software application 
processes. 

28. The computer program product of claim 21, wherein the number of 

15 events to be retrieved from the event port is specified by the computer software 
application. 

29. The computer program product of claim 29, wherein the number of 
events to be retrieved from the event port is specified by the computer software 

20 application based on user input. 

30. The computer program product of claim 21, further comprising 
instructions to: 

determine whether there are any requests in the request queue that can 
25 be satisfied by the available number of events at the event port, if fewer events 
than the specified number of events are available at the event port; and 

retrieve the specified number of events from the event port for one or 
more such requests and returning the retrieved events to the requesting computer 
software application, if there are requests in the request queue that can be 
30 satisfied. 
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31. The computer program product of claim 21, wherein the request has an 
associated timeout prior to which the request must be satisfied. 

32. The computer program product of claim 31, further comprising 
5 instructions to: 

retrieve all the available events at the event port at the time of timeout if a 
timeout occurs for a request while the request is in the request queue; and 

return the request to the computer software application with the retrieved 

events. 

10 

33. The computer program product of claim 21, further comprising 
instructions to: 

return an empty request to the requesting software application if the 
request cannot be satisfied. 

15 

34. The computer program product of claim 33, wherein the instructions to 
return comprise instructions to: 

return the empty request together with an error code indicating the cause 
for why the request cannot be satisfied. 

20 

35. The computer program product of claim 21, further comprising 
instructions to: 

return an empty request to the requesting software application if one or 
more of the following error conditions occur: 
25 the request contains an invalid event port identifier, an event or a list of 

events list cannot be delivered, a timeout argument is out of range, and a timeout 
interval expires before an expected number of events has been posted to the 
event port. 

30 36. The computer program product of claim 21, wherein the instructions to 
return the retrieved events to the requesting computer software application 
comprise instructions to return one or more of: 
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one or more detected events, one or more event source identifiers where 
the detected events were generated, one or more objects specific to an event 
source, and one or more user defined values. 

5 37. The computer program product of claim 21, further comprising 
instructions to: 

identify the number of available events at the event port if the specified 
number of events is zero; and 

inform the requesting computer software application of how many events 
10 are available at the event port. 

38. The computer program product of claim 21., wherein the events are 
asynchronous events. 

15 39. The computer program product of claim 21, wherein the events are 
transaction events. 

40. The computer program product of claim 21, wherein the event sources 
include one or more of: input devices, output devices, timers, signals, file 

20 updates, applications, system libraries, and drivers. 

41 . A queue management apparatus for retrieving transaction events 
generated by one or more event sources in a computer system, comprising: 

an event queue for receiving transaction events generated by one or more 
25 event sources, the event queue being accessible through an event port; 

a request queue for holding requests to retrieve transaction events from 
the event queue, each request having an associated priority determining a place 
of the request in the request queue; and 
a queue manager operable to: 
30 receive requests from a computer software application; 

organize the received requests in the request queue; 

determine whether a sufficient number of events are available in 

28 



Attorney Docket No.: SUN1 P765/SUN040374 



the event queue to fill a request with a highest priority in the request 
queue; and 

if a sufficient number of events is available in the event queue, 
retrieve the events needed to fill the request with the highest priority in 
5 the request queue through the event port and return the filled request to 

the requesting computer software application. 

42. The queue management apparatus of claim 41, wherein the request 
queue includes one or more stacks, each stack containing two or more requests 

10 with a same priority, the stacks being ordered in the request queue based on the 
priority of the requests in the respective stacks. 

43. The queue management apparatus of claim 41, wherein the priority of a 
request is indicated by a number of events to be retrieved by the request. 

15 

44. The method of claim 41, wherein a request in the request queue has an 
associated timeout prior to which the request must be satisfied. 
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